home *** CD-ROM | disk | FTP | other *** search
/ Aminet 30 / Aminet 30 (1999)(Schatztruhe)[!][Apr 1999].iso / Aminet / util / arc / CheckX.readme < prev    next >
Text File  |  1999-03-02  |  9KB  |  183 lines
  1. Short:    V1.47 Check for Archives/Packers/Viruses
  2. Author:   stoecker@amigaworld.com (Dirk Stoecker)
  3. Uploader: stoecker@amigaworld.com (Dirk Stoecker)
  4. Type:     util/arc
  5. Requires: util/arc/xadmaster.lha
  6.  
  7.           util/pack/xfdmaster.lha
  8.           util/virus/xvsLibrary.lha
  9.           util/pack/xpk_User.lha
  10. Version:  1.47
  11.  
  12. This program uses xfdmaster.library (see util/pack/xfdmaster.lha) and
  13. xvs.library (util/virus/xvsLibrary.lha) for packer and virus scanning.
  14. The xadmaster.library (see util/arc/xadmaster.lha) is used to dearchive
  15. file and disk archives.
  16.  
  17. NOTE: xadmaster.library is Shareware, so think about registering when
  18. using this utility together with that library (and without it's nearly
  19. useless). See conditions in xadmaster.library distribution.
  20.  
  21. The xfdmaster.library is needed to run the utility. The xvs.library and
  22. xadmaster.library are recommended! The xpkmaster.library is needed with
  23. ASKPWD password only (and to decrunch XPKF files).
  24.  
  25. CheckX unpacks archives and packed files as deep as possible:
  26.  - you can unarchive a crunched archive as well
  27.  - multiple crunched files can be decrunched
  28.  - multiple archives can be extracted
  29.  - multiple disk archives can be extracted
  30.  - linked and crunched and archived files are no problem
  31.  
  32. This all depends mainly on your memory size! If have around 50MB and have
  33. only little problems with really large archives.
  34.  
  35. Call CheckX with a ? and you get following argument list:
  36.  FROM,LOG,SAVE/K,ALL/S,ASKPWD/S,AUTOMOUNT/S,PRINTALL/S,PRINTEXEC/S,
  37.  NODECRUNCH/S,NOUNLINK/S,NOUNARCHIVE/S,NOUNTRACK/S,NOTRACKCUT/S,NOSTRIP/S,
  38.  NOVIRUS/S
  39.  
  40. Enter a ? again and you get a short doc:
  41.  FROM        source file or directory - may contain patterns
  42.  LOG         log file name
  43.  SAVE        directory, where decrunched files are saved
  44.  ALL         scan deep into directories
  45.  ASKPWD      ask for password when needed (needs xpkmaster.library)
  46.  PRINTALL    print all filenames
  47.  PRINTEXEC   print names of all executable files
  48.  AUTOMOUNT   automatically mount RDx: device when needed
  49.  NODECRUNCH  do not decrunch files with xfdmaster
  50.  NOUNLINK    do not unlink files with xfdmaster
  51.  NOUNARCHIVE do not call archiver for unarchiving file archives
  52.  NOUNTRACK   do not call archiver for unarchiving track archives
  53.  NOTRACKCUT  do not call archiver for partially track archives
  54.  NOSTRIP     do not strip useless hunks
  55.  NOVIRUS     do not scan with xvs.library for viruses
  56.  
  57. A bit more explanation:
  58. LOG         The output is written to a file as well as to the standard
  59.             output stream. The main purpose CheckX was written for is
  60.             to scan for crunched files and to test the decrunch
  61.             routines. So the logging may take some more time, but is
  62.             very stable, as the last log-entry is always the file which
  63.             possibly crashed the machine.
  64.             The logfile can be accessed by other progress for read and write
  65.             the whole time CheckX works (and surely after that). But writing
  66.             is not recommended, as this may produce a corrupted file.
  67. SAVE        If this keyword is given, all uncrunched/unlinked/stripped
  68.             files will be saved in the directory given with that keyword.
  69.             The directory must already exist! Sub directories are created
  70.             automatically.
  71.             If files are unlinked, they get saved with .1, .2, ...
  72.             extensions. Address crunched files are not saved. use
  73.             xfdDecrunchAddr or xfdDecrunch to do so.
  74. AUTOMOUNT   To unarchive disk archives (DMS, Zoom) a destination device
  75.             is needed. These devices are called RD0: to RDn: and for high
  76.             density disks RH0: to RHn:. CheckX can automatically mount
  77.             these or you may mount them before calling the program.
  78.             The number n depends on the archiver depth, so normally RD1:
  79.             should be the highest one really needed. High density disks
  80.             (RHn:) are not supported yet, as DMS seems to have problems
  81.             here.
  82. NOTRACKCUT  This prevents unarchiving of cutted (DMS) archives. Splitted
  83.             DMS-Archives may produce strange errors, but can be checked
  84.             correctly, when the two parts are directly after another (e.g.
  85.             no other track archive is between them). In this case the first
  86.             file shows some XPKCERR_READWRITE and the second one the
  87.             correct stuff. I checked EuroScene1 CD which has a lot cutted
  88.             archives and newest xfdmaster.library had no problems, so
  89.             probably this option is not needed anymore.
  90.  
  91. CheckX cannot scan files, which are read-protected. You get CheckX error 4
  92. as result in that case. Unprotect files and scan again when you want. For
  93. files contained in archives, the protection bits are ignored.
  94.  
  95. CheckX is completely reentrant and may work fine twice or more times
  96. parallel (You can set the pure file protection bit and make it resident),
  97. with one exception: Destination Disks (RDn: or RHn:) can be accessed only
  98. by one tool! So when source path contains disk archives, start only one
  99. copy of CheckX or use NOUNTRACK!!! It is not recommended to call it multiple
  100. times as CheckX normally needs lots of memory.
  101.  
  102. This is a batch tool, so drink a coffee or two or three during its work.
  103. Check the logfile afterwards. Use a text-editor and scan case sensitive
  104. for "-Virus" and you get lines which a related to viruses (and mostly
  105. only the important lines). A scan with "XFD", "XAD" or "CheckX" brings
  106. lines which produced errors.
  107.  
  108. The complete number of found viruses is logged at the file end (If the
  109. scan found some of them). Also the scan time is logged.
  110.  
  111. To get CheckX really silent either use LOG option and call CheckX with
  112. ">NIL:" or redirect normal autput into logfile with ">filename".
  113.  
  114. CheckX detects all the viruses found by xvs.library, which contains the
  115. complete antivirus knowledge of VirusZ utility by Georg Hörmann. CheckX
  116. cannot detect viruses in memory or remove detected viruses. You still
  117. need antivirus software like VirusZ, VT or Virus_Checker. I always run
  118. VirusZ in the background to check for viruses.
  119. CheckX also scans disk archive information texts for packers and viruses. 
  120. At the moment CheckX does not scan bootsectors of dearchived disks. This
  121. will be implemented soon.
  122.  
  123. If there are serious errors, please report them, but CheckX has a long
  124. way of development and I hope it is really stable now (as well as
  125. xfdmaster.library is now).
  126. Send me files, which cause the system to bring Enforcer/MungWall/PatchWork
  127. Hits or crash the computer. If the files are larger, please contact me
  128. first.
  129.  
  130. Stuff which becomes obsolete soon:
  131.  As xadmaster.library is still in development some important archivers are
  132.  still missing, so internal routines detect LhA, LhASFX, Zip, Zoo, Arc
  133.  and Zoom archives. The corresponding programs are called to dearchive
  134.  these files.
  135.  
  136.  Especially in UNARCHIVE mode this tool may need lots of memory (when T: is
  137.  assigned to ram disk). Keep that in mind! Every checked file is completely
  138.  loaded into memory! If you have low memory I would suggest assigning T: to
  139.  harddisk to get better results. Note this is no longer necessary, when
  140.  xadmaster.library includes all the missing clients, so I will not create
  141.  a TEMPDIR argument or like that.
  142.  
  143.  The program works fine with following archivers:
  144.  Arc             0.23                    50328 bytes
  145.  LhA             1.98                    52348 bytes
  146.  UnZip           5.32                    92992 bytes
  147.  Zoo             2.1 Beta 3              54608 bytes
  148.  Zoom            5.4                     82180 bytes
  149.  
  150. This program is Freeware. Use it as you want, but WITHOUT ANY WARRANTY!
  151.  
  152. Contact me at:
  153.  
  154. ************************************************************************
  155. * snail-mail:                  * e-mail:                               *
  156. *   Dirk Stoecker              *   stoecker@amigaworld.com             *
  157. *   Geschwister-Scholl-Str. 10 *   dstoecker@gmx.de                    *
  158. *   01877 Bischofswerda        * world wide web:                       *
  159. *   GERMANY                    *   http://home.pages.de/~Gremlin/      *
  160. * phone:                       * pgp key:                              *
  161. *   GERMANY +49 (0)3594/706666 *   get with finger or from WWW pages   *
  162. ************************************************************************
  163.  
  164.  
  165. ============================= Archive contents =============================
  166.  
  167. Original  Packed Ratio    Date     Time    Name
  168. -------- ------- ----- --------- --------  -------------
  169.      628     256 59.2% 11-Feb-99 19:22:22  CheckX.info
  170.    11888    6820 42.6% 11-Feb-99 19:22:46 +CheckX
  171.     8332    3433 58.7% 11-Feb-99 19:23:02 +CheckX.readme
  172.     1949     422 78.3% 11-Feb-99 19:23:02 +RD-MountList
  173.    50353   14849 70.5% 11-Feb-99 19:23:10 +CheckX.c
  174.     2184     806 63.0% 11-Feb-99 19:22:22 +SDI_ASM_STD_functions.lib
  175.     5632    1977 64.8% 11-Feb-99 19:22:22 +SDI_ASM_STD_protos.h
  176.     1165     457 60.7% 11-Feb-99 19:22:22 +SDI_compiler.h
  177.     3492    1525 56.3% 11-Feb-99 19:22:22 +SDI_defines.h
  178.      375     255 32.0% 11-Feb-99 19:23:10 +SMakeFile
  179.     1362     689 49.4% 11-Feb-99 19:23:10 +StartCode.a
  180.      180     167  7.2% 11-Feb-99 19:23:10 +StartCode.o
  181. -------- ------- ----- --------- --------
  182.    87540   31656 63.8% 13-Feb-99 01:00:56   12 files
  183.